Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-MST-016 |
| Deskripsi | Mengelola mata uang brand: daftar kurs, set rate, dan riwayat |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-03 |
| Keterangan | Inisiasi dokumentasi |
1. Ringkasan
a. In scope
- User dapat melihat daftar currency brand
- User dapat menambah / set nilai kurs currency
- User dapat mengubah kurs currency
- User dapat melihat riwayat perubahan kurs
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan daftar currency |
| FR-02 | User dapat set / create kurs currency |
| FR-03 | User dapat mengubah kurs currency |
| FR-04 | User dapat melihat riwayat kurs |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat daftar currency |
| UC-02 | Men set kurs currency |
| UC-03 | Mengubah currency |
| UC-04 | Melihat riwayat currency |
4. Use Case Scenario
UC-01 : Melihat daftar currency
| Aktor | User brand |
| Deskripsi | User melihat daftar currency pada brand aktif |
| Prekondisi | User sudah login Brand aktif terpilih |
| Alur utama | 1. User membuka halaman daftar currency. 2. Sistem menampilkan daftar beserta pagination dan filter bila ada. |
| Alur negatif | - Jika sesi tidak valid, user diarahkan ke login. - Jika permintaan gagal, daftar kosong atau muncul pesan gagal memuat. |
| Bisnis rule | - Data yang ditampilkan terikat brand aktif (header konteks brand). - Pagination mengikuti parameter halaman di UI. |
| Postkondisi | Daftar currency tampil |
| Trigger | User membuka menu currency |
| Kode FR | FR-01 |
UC-02 : Men set kurs currency
| Aktor | User brand |
| Deskripsi | User men set kurs untuk pasangan mata uang |
| Prekondisi | User sudah login Brand aktif User punya hak tambah |
| Alur utama | 1. User pilih currency. 2. Input kurs. 3. Simpan via POST currency. |
| Alur negatif | - Jika validasi gagal, data tidak tersimpan dan field error ditampilkan. - Jika tidak berwenang, simpan ditolak. |
| Bisnis rule | - Create memakai POST /currency/:id dengan body kurs. |
| Postkondisi | Currency baru tersimpan |
| Trigger | User klik tambah currency |
| Kode FR | FR-02 |
UC-03 : Mengubah currency
| Aktor | User brand |
| Deskripsi | User mengubah data currency yang sudah ada |
| Prekondisi | User sudah login Data sudah ada User punya hak ubah |
| Alur utama | 1. User membuka detail / form ubah currency. 2. User mengubah field. 3. User menyimpan. 4. Sistem memperbarui data. |
| Alur negatif | - Jika validasi gagal, perubahan tidak tersimpan. - Jika record tidak ditemukan, ubah gagal. |
| Bisnis rule | - Update memakai PUT /currency/:id. |
| Postkondisi | Data currency terbarui |
| Trigger | User menyimpan perubahan |
| Kode FR | FR-03 |
UC-04 : Melihat riwayat currency
| Aktor | User brand |
| Deskripsi | User melihat history perubahan kurs |
| Prekondisi | Currency ada |
| Alur utama | 1. User buka riwayat dari daftar. 2. Sistem tampilkan history. |
| Alur negatif | - Tidak ada history → daftar kosong. |
| Bisnis rule | - |
| Postkondisi | Riwayat tampil |
| Trigger | Klik riwayat currency |
| Kode FR | FR-04 |
5. Data Flow Diagram
DFD-01
6. Sequence Diagram
SD-01 — UC-01 : Daftar currency
SD-02 — UC-02 : Set kurs
SD-03 — UC-03 : Ubah kurs
SD-04 — UC-04 : Riwayat currency
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /currency | existing | - |
POST /currency/:id | existing | - |
PUT /currency/:id | existing | - |